CLIM 2.0 Release Notes and Installation Guide 



Overview of CLIM 2.0 

CLIM 2.0 is a new release of CLIM whose primary goal is to provide support for 
toolkit-style programming in CLIM. To this end, CLIM 2.0 implements a large 
amount of new support for window and event management, and also includes a 
portable interface to a set of gadgets, including scroll bars, push buttons, toggle 
buttons, radio and check boxes, sliders, list and option panes, and text editing 
panes. 

CLIM 2.0 also includes hundreds of bugfixes, many customer-requested enhance- 
ments, and is more robust than CLIM 1.1. 



Installing CLIM 2.0 

Note: You cannot load CLIM 2.0 into a world that has a previous version of CLIM 
(such as CLIM 1.1) loaded. 

The CLIM 2.0 system is distributed on the Genera 8.3 CD-ROM (with the excep- 
tion of some 3600-family only sites, with the CLIM 2.0 on the Genera 8.3 source 
tapes.) 

To install CLIM into a Genera world, do the following: 

1. Boot a world that does not include CLIM 1.0 or CLIM 1.1. Use Restore Dis- 
tribution to restore the following CLIM systems from the distribution tape, if 
you have not done so already: 

CLIM 

Genera-CLIM 

CLX-CLIM 

PostScript-CLIM 

CLIM-Demo 

2. Load the restored systems: 

Load System CLIM 

Load System Genera-CLIM 

Load System CLX-CLIM [if you want the CLX port loaded] 

Load System PostScript-CLIM [if you want the PostScript port loaded] 

Load System CLIM-Demo [if you want the CLIM demos loaded] 

3. Save a world with the CLIM 2.0 systems loaded. 



New Features in CLIM 2.0 

The main new feature in CLIM is the integrated support for gadgets and event 
management. Refer to Common Lisp Interface Manager (CLIM): Release 2.0 for 
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more information about gadgets and event management. Some of the new features 
of CLIM 2.0 include the following: 

• A new window and event management model that supports use of standard user 
interface toolkits when running on standard platforms, such as Motif under Alle- 
gro Common Lisp. Since Genera does not support toolkits like Motif, CLIM 2.0 
includes a set of gadgets, including scroll bars, push buttons, toggle buttons, ra- 
dio and check boxes, pull-down menus, sliders, text editing panes, and list and 
option panes. 

• Integration between CLIM's gadgets and climraccepting-values. 

• The completion presentation types now support rprinter and rhighlighter op- 
tions. 

• A set of drawing functions that draw multiple graphics, for example, climrdraw- 
lines* and climrdraw-rectangles*. 

• CLIM 2.0 supports use of pixmaps, and has clim:with-output-to-pixmap and 
clim:copy-area functions. This can be used to cache portions of a display that 
needs to be rapidly, repeatedly drawn. 

• Functions to read Xll bitmap files and convert them to CLIM patterns, such as 
climrmake-pattern-froin-bitinap-file. 

• The input editor has a much richer set of editing commands. Type control-Help 
to see the entire set of commands. 

• The appearance of the mouse cursor can be changed, either directly by calling 
setf on climrpointer-cursor, or by changing the cursor associated with a CLIM 
sheet by calling setf on climrsheet-pointer-cursor. 

• Command tables may now inherit menu items from superior command tables. 

• The command processor now tells you what the defaults are for keyword argu- 
ments when you type Help while reading a command. 

• Keyboard gestures are now specified in a more portable fashion. For example, 
what would have been tfXcontrol-X in CLIM 1.1 is now specified as (:x : con- 
trol). This allows greater portability, but it is an incompatible change from 
CLIM 1.1. 

• A new form for defining drag-and-drop translators, called climrdefine-drag-and- 
drop-translator. 

• clim:surrounding-output-with-border now takes drawing options. 

• The graph formatter is now more sophisticated. 
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• A number of new demos, including a "color chooser", a simple bitmap editor, a 
simple graphical editor, a Peek-like utility, a data plotting program, and a 
graphical browser. Note that these are demo programs; they are not intended to 
be of product quality, but are meant to be instructive in the use of CLIM 2.0. 
The CLIM Lisp Listener is particularly useful when you are debugging frag- 
ments of CLIM code; type Select Lambda (symbol -shift-L) to use it. 

• The new clim-sys package contains a number of generally useful utilities. 



Enhancements and Bugfixes in CLIM 2.0 

In many respects, CLIM 2.0 is a more robust release than CLIM 1.1. However, as 
this is a new major release with much new functionality, some bugs in the new 
code are to be expected. Some of the bugs that have been fixed since CLIM 1.1 are 
listed as follows: 

clim:accept-from-string and clim:present-to-string work much better. 

The rallow-sensitive-inferiors argument to climrpresent and climrwith-output- 
as-presentation now works. 

The highlighting of multi-line text output records is now better. 

The problems with completion over or types have been fixed. 

A bug in clim:identity-translator-applicable-p has been fixed that makes pre- 
sentations with type parameters behave correctly. 

Clipping regions for output records now work correctly. 

The problem where the input editor would blow out after you cleared the input 
buffer and then clicked on something has been fixed. 

Typeout from the input editor no longer scribbles over the user's typein. 

Own-window dialogs now have their own help window. 

The command processor tries to insert a delimiter between arguments as you 
click on them, if it can. This allows mixed-mode interfaces to be much more 
streamlined. 

Textual output is faster. Furthermore, diacritic characters (such as acute ac- 
cents) are now handled properly. 

Some long-standing problems in coordinate sorted sets have been ameliorated, 
but not completely fixed. 
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• Some problems in incremental redisplay have been fixed. This includes bugs in 
redisplay of climrformatting-table and climrformat-graph-froin-roots, and prob- 
lems redisplaying overlapping output records. 

• climrfilling-output much faster when you use write-string. 

• climrtracking-pointer handles mouse button-up events properly. 

• Successive calls clim:surrounding-output-with-border now line up correctly. 

• Some problems in climrmake-design-froin-output-record have been fixed. 

• Suspend and meta-Suspend now work much better in Genera GLIM applications. 

• The PostScript back-end now works much better. For example, the font metrics 
are now computed correctly. 

Functions Incompatibly Changed From CLIM 1.1 

The following functions were incompatibly changed from GLIM 1.1 to GLIM 2.0. 
You can use Zmacs's Conversion Tools (m-X Convert Functions ...) to automate 
much of the conversion process; use the "CLIM 1.1 to CLIM 2.0" conversions. 

• The rpanes and rlayouts clauses to clim:define-application-frame are now com- 
pletely different. No conversions have been provided, since it is not clear what 
should be done in many cases. 

• clim:set-frame-layout has been removed in favor of using setf on climrframe- 
current-layout. 

• clim:frame-top-level-window is now called clim:frame-top-level-sheet. 

• clim:command-enabled-p is now called climrcommand-enabled. 

• clim:disable-command and climrenable-command have been removed in favor 
of using setf on climrcommand-enabled. 

• clim:run-frame-top-level now takes keyword arguments. You must include &key 
in your methods for this function. 

• clim:open-root-window has been removed. Its closest replacement is climrfind- 
port, although you may find that you rarely need to explicitly specify a port. 

• The rstream, robject, and :type keyword arguments to clim:with-output-as- 

presentation are now required arguments, since it was always necessary to sup- 
ply these arguments. 
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• clim:+background+ is now called clim:+background-ink+, and 
cliin:+foreground+ is now called cliin:+foreground-ink+. This was done to be 
consistent with cliin:+flipping-ink+. 

• climrmake-color-rgb is now called climrmake-rgb-color, and climrmake-color- 
ihs is now called climrmake-ihs-color. 

• climrdraw-character, climrdraw-character*, climrdraw-string, and climrdraw- 
string* have all been removed in favor of using climrdraw-text and climrdraw- 
text*. 

• climrdraw-icon and climrdraw-icon* are now called climrdraw-pattern*. 

• The argument order to climrwith-text-style, climrwith-text-family, climrwith- 

text-face, and climrwith-text-size has been changed so that the stream argu- 
ment is first. 

• clim:add-text-style-mapping has been removed in favor of using setf on 
clim:text-style-mapping. 

• climrstream-cursor-position* is now called climrstream-cursor-position, 
clim:stream-set-cursor-position* is now called clim:stream-set-cursor-position, 
and climrstream-increinent-cursor-position* is now called climrstream- 
increment-cursor-position. 

• climrcursor-position* is now called climrcursor-position, and clim:cursor-set- 
position* is now called clim:cursor-set-position. 

• clim:stream-vsp is now called climrstream-vertical-spacing. 

• The argument order to climrwith-end-of-line-action and climrwith-end-of-page- 

action has been changed so that the stream argument is first. 

• climrstream-pointer-position* is now called climrstream-pointer-position, and 
clim:stream-set-pointer-position* is now called clim:stream-set-pointer- 
position. 

• climrpointer-position* is now called climrpointer-position, and clim:pointer-set- 
position* is now called clim:pointer-set-position. 

• climrevent-window is now called climrevent-sheet. 

• climrpointer-event-shift-mask is now called climrevent-modifier-state. 

• The rinter-column-spacing, :inter-row-spacing, and :multiple-columns-inter- 
column-spacing keyword arguments to clim:formatting-table have been re- 
named to :x-spacing, :y-spacing, and :multiple-columns-x-spacing. 



Page 571 



• The rminimuin-width and rminimuin-height keyword arguments to 
climrformatting-cell have been renamed to rmin-width and rmin-height. 

• The rinter-column-spacing, :inter-row-spacing, and :no-initial-spacing keyword 
arguments to climrformatting-itein-list and climrformat-iteins have been re- 
named to :x-spacing, :y-spacing, and rinitial-spacing. 

• The rinter-column-spacing and :inter-row-spacing keyword arguments to 
climrmenu-choose and clim:draw-standard-menu have been renamed to :x- 
spacing and :y-spacing. 

• The :draw-p and :record-p keyword arguments to climrwith-output-recording- 
options have been renamed to :draw and rrecord. 

• clim:*unsupplied-argument* is now called 
clim:*unsupplied-argument-marker*. 

• The rinter-column-spacing and :inter-row-spacing keyword arguments to 
clim:display-command-table-menu has been renamed to :x-spacing and :y- 
spacing. 

• The :test keyword argument has been removed from clim:add-command-to- 
command-table, clim:add-keystroke-to-command-table, and climrremove- 
keystroke-from-command-table. 

• The :keystroke-test keyword argument has been removed from climrread- 
command and clim:read-command-using-keystrokes. 

• climrwindow-viewport-position* is now called climrwindow-viewport-position, 
and clim:window-set-viewport-position* is now called clim:window-set- 
viewport-position. 

• clim:position-window-near-carefully is now called 
clim:position-sheet-carefully. 

• clim:position-window-near-pointer is now called clim:position-sheet-near- 
pointer. 

• clim:size-menu-appropriately is now called clim:size-frame-from-contents. 

• clim:stream-draw-p is now called clim:stream-drawing-p, and climrstream- 
record-p is now called clim:stream-recording-p. 

• climroutput-record-position* is now called climroutput-record-position, and 
clim:output-record-set-position* is now called clim:output-record-set-position. 
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• clim:output-record-start-position* is now called clim:output-record-start- 
cursor-position, and clim:output-record-end-position* is now called 
clim:output-record-end-cursor-position. 

• clim:output-record-set-start-position* is now called clim:output-record-set- 
start-cursor-position, and clim:output-record-set-end-position* is now called 
clim:output-record-set-end-cursor-position. 

• clim:output-record-element-count is now called clim:output-record-count. 

• climroutput-record-elements is now called climroutput-record-children. 

• clim:replay-l is now called climrreplay-output-record. 

• clim:output-record-refined-sensitivity-test is now called climroutput-record- 
refined-position-test. 

• climroutput-recording-stream-output-record is now called climrstream-output- 
history. 

• clim:output-recording-stream-current-output-record-stack is now called 
climrstream-current-output-record. 

• climroutput-recording-stream-replay is now called climrstream-replay. 

• climradd-output-record is now called clim:stream-add-output-record. 

• climradd-output-record-element is now called climradd-output-record, and 
climrdelete-output-record-element is now called climrdelete-output-record. 

• clim:map-over-output-record-elements is now called clim:map-over-output- 
records, clim:map-over-output-record-elements-containing-point* is now called 
clim:map-over-output-records-containing-position, and clim:map-over-output- 
record-elements-overlapping-region is now called clim:map-over-output- 
records-overlapping-region. 

• clim:redisplay-l is now called climrredisplay-output-record. 

• climrdragging-output-record is now called climrdrag-output-record. 

• The frame argument to climrfind-presentation-translators is now a command- 
table argument. 

• The :shift-mask keyword argument to climrtest-presentation-translator, 
climrfind-applicable-translators, clim:presentation-matches-context-type, and 
climrfind-innermost-applicable-presentation is now a :modifier-state argument. 
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• clim:define-gesture-name uses a completely different syntax for specifying the 
gesture, and clim:add-pointer-gesture-name has been replace by climradd- 
gesture-name. 

• clim:remove-pointer-gesture-name is now called clim:delete-gesture-name. 

• climrdialog-view is now called climrtextual-dialog-view, and cliin:+dialog-view+ 
is now called clim:+textual-dialog-view+. 

• climrmenu-view is now called climrtextual-menu-view, and cliin:+inenu-view+ 
is now called cliin:+textual-inenu-view+. 

• climrcall-presentation-generic-function has been replaced by a pair of func- 
tions, climrapply-presentation-generic-function and climrfuncall-presentation- 
generic-function. 

• The ractivation-characters, radditional-activation-characters, :blip-characters, 
and :additional-blip-characters to climraccept are now called ractivation- 
gestures, radditional-activation-gestures, rdelimiter-gestures, and radditional- 
delimiter-gestures. 

• clim:*activation-characters* is now called clim:*activation-gestures*, and 
clim:*standard-activation-characters* is now called clim:*standard-activation- 
gestures*. 

• cliin:*blip-characters* is now called cliin:*deliiniter-gestures*. 

• clim:activation-character-p is now called clim:activation-gesture-p, climrblip- 
character-p is now called clim:delimiter-gesture-p. 

• climrwith-activation-characters is now called climrwith-activation-gestures, 
and clim:with-blip-characters is now called climrwith-delimiter-gestures. 

• clim:*abort-characters* is now called clim:*abort-gestures*. 

• clim:*complete-characters* is now called clim:*completion-gestures*, 
clim:*help-characters* is now called clim:*help-gestures*, and 
clim:*possibilities-characters* is now called clim:*possibilities-gestures*. 

• climrinput-position is now called clim:stream-scan-pointer, and climrinsertion- 
pointer is now called climrstream-insertion-pointer, and clim:rescanning-p is 
now called clim:stream-rescanning-p. 

• The right and bottom arguments to climrwith-bounding-rectangle* are now re- 
quired. 

• climrpoint-position* is now called climrpoint-position. 
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• clim:region-contains-point*-p is now called clim:region-contains-position-p. 

• climrbounding-rectangle-position* is now called climrbounding-rectangle- 
position, and clim:bounding-rectangle-set-position* is now called 
clim:bounding-rectangle-set-position. 

• The argument order to climrmake-S-point-transforination and climrmake-S- 
point-transformation* has been changed. 

• climrcompose-rotation-transformation is now called climrcompose-rotation- 
with-transformation, climrcompose-scaling-transformation is now called 
clim:compose-scaling-with-transformation, and climrcompose-translation- 
transformation is now called clim:compose-translation-with-transformation. 

• climrtransform-point* is now called climrtransform-position, and 
climruntransform-point* is now called climruntransform-position. 



